home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / os2 / lopbk505.zip / LOOPBACK.DOC < prev    next >
Text File  |  1997-03-25  |  104KB  |  2,068 lines
  1.                                   Loop-Back
  2.                                     [PPE]
  3.                               Call-Back Verifier
  4.                                     v5.05
  5.  
  6.               Copyright (c)96,1997 by Practical Computer Services
  7.  
  8.                      For use with PCBoard v15.2x and above
  9.  
  10. ------------------------------------------------------------------------------
  11. Trademarks & Copyright Information:
  12. -----------------------------------
  13.  
  14.     PCBoard is a registered trademark of Clark Development Company, Inc.
  15.     PCBoard is copyright (c) 1985-1997 by Clark Development Company, Inc.
  16.     PPLC is copyright (c) 1993-1997 by Clark Development Company, Inc.
  17.     PPL is a trademark of Clark Development Company, Inc.
  18.     PCBEdit is copyright (c) 1993 by Clark Development Company, Inc.
  19.     LoopBack is copyright (c) 1993-1997 by Practical Computer Services
  20.     LoopUtil is copyright (c) 1994-1997 by Practical Computer Services
  21.  
  22.     All other brand and product names mentioned in this manual are trademarks
  23.     or registered trademarks of their respective companies.
  24.  
  25. ------------------------------------------------------------------------------
  26. Disclaimer:
  27. -----------
  28.      Practical Computer Services (herein referred to as PCS) does not assume
  29.      any liability arising out of the application or use of any products
  30.      described herein. PCS reserves the right to make changes of any products
  31.      described herein without notice.  This document is subject to change
  32.      without notice.
  33.  
  34. ------------------------------------------------------------------------------
  35. License:
  36. --------
  37.      LoopBack/LoopUtil is in no way, shape, or form public domain.  Upon 
  38.      installing LoopBack/LoopUtil, the user agrees to abide by all terms and
  39.      conditions contained in this and all documentation.  The user is granted
  40.      a 30 day license to run LoopBack/LoopUtil.  After 30 days, the user must
  41.      either delete all operating copies of LoopBack/LoopUtil or register the
  42.      software with PCS.  If the user has copies of LoopBack present on his/her
  43.      bulletin board, in their original archived format, for users to download, 
  44.      then he/she need not delete those copies.  Only copies that the SysOp is
  45.      using to callback users on his/her BBS must be deleted.  
  46.  
  47.      Any part or contents of this manual may not be reproduced or transmitted
  48.      in any form or by any means without the express written permission of
  49.      PCS.
  50.  
  51.      You may not attempt to disassemble or decompile any of the products 
  52.      contained in the archive.  
  53.  
  54. ------------------------------------------------------------------------------
  55. Warranty:
  56. ---------
  57.      LoopBack and LoopUtil do not contain any kind of warranty, express or 
  58.      implied.  LoopBack and LoopUtil are provided `as is'.  Any bugs or 
  59.      compatibility problems reported will be corrected as soon as possible.  
  60.  
  61. ------------------------------------------------------------------------------
  62. Registration & Support:
  63. ------------------------
  64.      
  65.      Registering LoopBack will do the following for you:
  66.  
  67.        1) Remove the UNREGISTERED delay at the beginning of LoopBack.
  68.  
  69.        2) Place your name & security code in the (L)oopInfo screen.
  70.  
  71.        3) You will receive VOICE and BBS support.
  72.      
  73.        4) You will receive our periodic newsletter announcing updates and
  74.           other product developments. If you have an internet e-mail
  75.           address, we also have a PCS-NEWS listserv available.
  76.  
  77.      To register LoopBack/LoopUtil, fill out the file REGISTER.FRM and do one
  78.      of the following:
  79.       
  80.            1) : Print out the form and mail it along with a check or money
  81.                 order to the following address:
  82.             
  83.                 Practical Computer Services
  84.                 483 Klockner Road
  85.                 Hamilton, NJ 08619
  86.  
  87.                 After receiving the check/money order an account will be
  88.                 setup for you on The TAO BBS. (If you do not already
  89.                 have one setup).  You may then call in to receive your
  90.                 registration codes. Or, your codes can be mailed to you.
  91.                 The choice is yours. Calling our support BBS is of course
  92.                 a lot faster then the mail. :)
  93.  
  94.            2) : Register with your info, online.  Recieve your keys
  95.                 immediately. Logon on to the support board, and type 
  96.                 KEY.
  97.  
  98.      The registration prices of LoopBack/LoopUtil are as follows:
  99.  
  100.              LoopBack Registration
  101.            ------------------------  
  102.              $25 registration
  103.              
  104.              
  105.              LoopBack Major Update
  106.            ------------------------
  107.              $10 upgrade fee
  108.  
  109.              Universal Registration (registers all UNIVERSAL PPE's)
  110.            ------------------------
  111.              $40.00
  112.        
  113.        All minor updates may be freely downloaded and do not cost you a 
  114.        penny.  However, if you wish to have a new disk sent to you, there will
  115.        be a $5 fee.
  116.               
  117.        How to contact PCS:
  118.  
  119.                 Practical Computer Services
  120.                 483 Klockner Road
  121.                 Hamilton, NJ 08619
  122.  
  123.         The TAO BBS: (33.6K baud)  (609) 587-2672 (MAIN SUPPORT BBS)
  124.  
  125.            Voice:  (609) 584-7947
  126.  
  127.             Fax:   (609) 587-0583
  128.  
  129.          E-Mail:  bob.watson@tao.com
  130.  
  131.        Web Site:  http://www.nerc.com/~pcs/
  132. ------------------------------------------------------------------------------
  133. Use and function:
  134. -----------------
  135.      LoopBack is a PCBoard Programming Language Executable file, or commonly
  136.      referred to as PPE.  This PPE will allow you to provide tighter and 
  137.      more efficient security for yourself, your co-SysOp, and your users.
  138.      LoopBack can be configured to call the user back and then upgrade their
  139.      security according to the type of call and the connection.  In this way,
  140.      you can make sure your users are using correct telephone numbers and in
  141.      the same instance keep multiple accounts out of your system.
  142.  
  143.      LoopUtil is also a PPE.  This PPE maintains most of the maintenance and
  144.      file editing/configuration for LoopBack.  With this PPE, the SysOp can
  145.      edit the prompt files, configuration file, trash files, etc.  This will
  146.      enable your remote co-SysOps to maintain LoopBack without the use of an
  147.      external door program.
  148.  
  149. ------------------------------------------------------------------------------
  150. Why choose a [PPE] over a door?
  151. --------------------------------
  152.      There are many advantages to running a PPE rather than a door.  Here is
  153.      a simple list of some of the advantages that you will have as a result
  154.      of running a PPE.
  155.       
  156.         1) Flexibility - With a PPE, you can replace any of your display 
  157.            prompts and actually rewrite that part of PCBoard to your 
  158.            specifications.  You may also place PPEs in display files.  So if
  159.            you wanted to only run LoopBack for users with a security level of
  160.            ten, then all you need to do is create a login security file, and
  161.            place the following line in it to execute LoopBack:
  162.            !C:\PCB\PPE\LOOPBACK\LOOPBACK.PPE
  163.  
  164.         2) Communications - With a PPE, communication with your COMM port is
  165.            not a problem.  Do you run a FOSSIL driver and just can't seem to
  166.            find a door to work right with it?  Are you using an Intelligent
  167.            Multi-Port serial card and cannot find a door to support it?  Are
  168.            you running OS/2 and cannot find anything to support your multi
  169.            port driver?  Then look no further!  Since a PPE runs within 
  170.            PCBoard, PCBoard handles all the communications for the PPE.  So if 
  171.            you have PCBoard setup to work with a 16-Port DigiBoard IM card, 
  172.            then your PPE will also know how to correctly talk to your modem..   
  173.            Same goes for FOSSIL drivers, the OS/2 COMM Routines, etc.
  174.  
  175.         3) Smooth operation - Ever had a door that could never figure out    
  176.            when someone has dropped carrier?  Or maybe you have a door that
  177.            is very slow to load and sometimes locks your system up..  If so,
  178.            then you need to replace that door with a PPE.  Again, since a
  179.            PPE runs within PCBoard, PCBoard handles all carrier detection, 
  180.            etc.  If someone drops carrier in a PPE, PCBoard recycles.  If 
  181.            someone has not entered a keystroke for the specified # of minutes,
  182.            PCBoard logs them off.  etc., etc.
  183.     
  184. ------------------------------------------------------------------------------
  185. Online Help: 
  186. -------------
  187.  
  188.      It is recommended that you read the documentation in its entirety, but
  189.      if you still do not understand something (particularly the dialing 
  190.      templates or allowed #s calling file) then try viewing the online help.
  191.      We are constantly adding new help files to each part of the LoopUtil
  192.      maintenance utility.  If you still do not understand after viewing the
  193.      online help, or there is no help available for the subject you do not
  194.      understand, then call The TAO BBS at (609) 587-2672 and leave a private
  195.      message for Bob Watson.
  196.  
  197. ------------------------------------------------------------------------------
  198. Excessive command line violations:
  199. ----------------------------------- 
  200.  
  201.      If you see the message "Excessive command line violations" in your 
  202.      callers log, do not be alarmed.  This is not a bug in the call-back 
  203.      verifier.  This is just the way that PCBoard processes the HANGUP 
  204.      statement in PPL.  I have been trying to find a way aroung it, but have
  205.      had no luck.  I will keep trying though.
  206.  
  207. ------------------------------------------------------------------------------
  208. Error loading PPE:
  209. -------------------
  210.  
  211.      If PCBoard displays a message such as "Error loading PPE from disk", 
  212.      then check to make sure you are running PCBoard v15.2x.  If you are not
  213.      running PCBoard v15.2x, then you must call Salt Air (1-801-261-8976) and
  214.      download the v15.2x code by typing PCBOARD at the main menu.  LoopBack
  215.      will not run with a version of PCBoard prior to v15.2.
  216.  
  217. ------------------------------------------------------------------------------
  218. Overlay buffers and memory problems:
  219. -------------------------------------
  220.      
  221.      The OVLSIZE.EXE program, included with PCBoard, is a very useful tool
  222.      for configuring the performance of your PPEs.  First, you need to know
  223.      how much memory you have available, and how much memory your largest 
  224.      PPE or door neLoop to operate.  Second, the more overlay buffers you 
  225.      have, the faster your PPEs will operate.  But you cannot make the 
  226.      buffers to large, or some of your PPEs and doors may not have enough 
  227.      memory to operate.  I suggest that if your PCBoard status line shows 
  228.      at least around 170K or so, you'll be alright.  I have my overlay 
  229.      buffers set at 21 (or 84K).  To change your overlay buffers, run OVLSIZE
  230.      with the following parameters:
  231.       
  232.      OVLSIZE.EXE <FILENAME> <SIZE>
  233.        
  234.      <FILENAME> is the path & filename of your PCBoard executable. 
  235.      <SIZE> is the size of your overlay buffers..
  236.  
  237.      Valid sizes are as follows:
  238.        
  239.          1 =  4K      9 = 36K     17 = 68K     25 = 100K
  240.          2 =  8K     10 = 40K     18 = 72K     26 = 104K
  241.          3 = 12K     11 = 44K     19 = 76K     27 = 108K
  242.          4 = 16K     12 = 48K     20 = 80K     28 = 112K
  243.          5 = 20K     13 = 52K     21 = 84K     29 = 116K
  244.          6 = 24K     14 = 56K     22 = 88K     30 = 120K
  245.          7 = 28K     15 = 60K     23 = 92K     31 = 124K
  246.          8 = 32K     16 = 64K     24 = 96K     32 = 128K
  247.  
  248.      When searching through the already used number trash file, I noticed a
  249.      30% speed increase when I changed my overlay buffers from 16 (or 64K) to
  250.      21 (or 84K).  
  251.  
  252.  
  253.      NOTE: You MUST be sure that all your programs and PPE files will be able
  254.            to execute after you change the overlay buffer setting.  If 
  255.            LoopBack or LoopUtil will not execute because PCBoard is reporting 
  256.            "Unable to allocate memory (SCRIPT BUFFER)", then you will need 
  257.            to do one of the following things.
  258.             
  259.             1) Try to maximize your window if using DESQview.
  260.  
  261.             2) Set "Pre-Load PCBTEXT" setting in PCBSetup to NO
  262.  
  263.             3) Set "Pre-Load CNAMES" setting in PCBSetup to NO
  264.  
  265.             4) Lower the amount of overlay buffers in your PCBOARD.EXE or
  266.                PCBBOARDM.EXE file.
  267.  
  268. ------------------------------------------------------------------------------
  269. Installation:
  270. -------------
  271.  
  272.      The following is a list of steps for the first time installation 
  273.      process:
  274.  
  275.        Step #1:  Make a directory to hold your LOOPBACK files ie:
  276.                  MD C:\PCB\PPE\LOOPBACK
  277.  
  278.        Step #2:  Unarchive LoopBack into this directory.
  279.  
  280.        Step #3:  Add both LOOPBACK & LOOPUTIL into your CMD.LST file
  281.                  (see the heading EXECUTING the LOOPBACK.PPE later in
  282.                   this document)
  283.  
  284.        Step #4:  Load up PCBoard and type the command that you setup to run
  285.                  the LOOPUTIL.PPE file.  (ie., LOOPUTIL)
  286.  
  287.        Step #5:  Select C to edit your configuration file.  (Information on
  288.                  configuration is explained later in the manual.)
  289.  
  290.        Step #6:  Select P to modify the prompts to your specifications.
  291.                  (The prompting system is explained later in the manual.) 
  292.  
  293.        Step #7:  Select N to modify your "Already Used # File".  You can use
  294.                  the BUILD feature to do this.  (The BUILD feature is explained
  295.                  later in the manual.)
  296.  
  297.        Step #8:  Select T to modify the timetables, if you need to use them.  
  298.                  (The timetable system is explained later in the manual.)
  299.  
  300.        Step #9:  Select B to modify the bad numbers file.  (This is the file
  301.                  that you want to put 911 in.)
  302.  
  303.       Step #10:  Select F to modify the name & security trash files to keep
  304.                  out those users that you do not want to be called back.
  305.  
  306.       Step #11:  Select A to modify the numbers that LoopBack is allowed to 
  307.                  callback.  (This is explained later in the manual)  Make sure
  308.                  you define your dialing templates!  (This is explained later in
  309.                  the manual)
  310.  
  311.       Step #12:  If you wish to install LoopBack as a NewUser login PPE, please 
  312.                  read the section in the manual entitled "Executing the 
  313.                  LOOPBACK.PPE file".
  314.       
  315.       Step #13:  Read the documentation in its entirety.
  316.       
  317. ------------------------------------------------------------------------------
  318. Configuration file maintenance via LoopUtil:
  319. --------------------------------------------
  320.  
  321.       Configuration Toggles
  322.      -----------------------
  323.       (1)  Allow international callbacks : This toggle will tell LoopBack
  324.            whether or not it is allowed to callback international numbers.
  325.            (If you do not absolutely need international callbacks, then 
  326.            set this option to No.  Certain features of LoopBack are not 
  327.            present when International callbacks are allowed.)
  328.  
  329.       (2)  User's time adjustment : This toggle will tell LoopBack how to 
  330.            adjust the user's time.  If it is set to (R)eplace, then the 
  331.            value set in the config settings will replace the user's time.
  332.            If it is set to (A)dd then the time value will be added to the 
  333.            user's time.  (If you do not want to adjust the user's time, then
  334.            set this toggle to (A)dd and set the time value in the dialing 
  335.            template to 0)
  336.  
  337.       (3)  Message type to send to the SysOp : This toggle will tell LoopBack
  338.            what kind of message to send to the SysOp.  If it is set to
  339.            (I)nternal LoopBack will generate an internal message to the SysOp.
  340.            (E)xternal will tell LoopBack to send the file defined in the
  341.            configuration paths (SysOp.MSG) to the SysOp.  (N)one will tell
  342.            LoopBack to send no message at all.
  343.  
  344.       (4)  Message type to send to the User : This toggle will tell LoopBack
  345.            what kind of message to send to the User.  If it is set to 
  346.            (I)nternal LoopBack will generate an internal message to the user. 
  347.            (E)xternal will tell LoopBack to send the file defined in the
  348.            configuration paths (USER.MSG) to the user.  (N)one will tell
  349.            LoopBack to send no message at all.
  350.  
  351.       (5)  Comment to use : This toggle will tell LoopBack what kind of 
  352.            comment to add to the user's record after a successful 
  353.            verification.  (D)ate will tell LoopBack to put the date and time
  354.            that the user was verified in the user record.  (P)hone will tell
  355.            LoopBack to put the phone number that was called back in the user
  356.            record.  (B)oth will tell LoopBack to put both the date & time 
  357.            verified and the phone number called back into the user's record.
  358.            (N)one will tell LoopBack to not place any kind of comment in the
  359.            user's record.
  360.  
  361.       (6)  Check user's name : This toggle will tell LoopBack whether or not
  362.            it should ask the user to enter his/her name for verification 
  363.            after callback.
  364.  
  365.       (7)  Check user's password : This toggle will tell LoopBack whether or
  366.            not it should ask the user to enter his/her password for 
  367.            verification after callback.
  368.  
  369.       (8)  Check user's verification string : This toggle will tell LoopBack 
  370.            whether or not it should ask the user to enter his/her 
  371.            verification string (mother's maiden name) for verification after
  372.            callback.
  373.  
  374.       (9)  Check user's city : This toggle will tell LoopBack whether or not
  375.            it should ask the user to enter his/her city (calling from) for
  376.            verification after callback.
  377.  
  378.      (10)  Upgrade local callers : This toggle will tell LoopBack whether or
  379.            not it should upgrade the status of a local caller after a
  380.            successful verification.  You may want to turn this toggle off if
  381.            you will be frequently texting LoopBack from a local node.
  382.      
  383.      (11)  Update user's data phone # : This toggle will tell LoopBack whether
  384.            or not it should change the user's data phone # to the number that
  385.            was used to call the user back.  
  386.      
  387.      (12)  Verify user's city : This toggle will tell LoopBack whether or not
  388.            it should ask the user if his/her name and city are correct.  This
  389.            is only needed for large systems who may have different callers
  390.            that have the same name.
  391.  
  392.      (13)  Allow user to use logoff command : This toggle will tell LoopBack
  393.            whether or not it should allow the user to logoff within LoopBack
  394.            without undergoing verification.
  395.  
  396.      (14)  Allow user to return to main : This toggle will tell LoopBack 
  397.            whether or not it should allow the user to return to the BBS 
  398.            without undergoing verification.
  399.            
  400.      (15)  Allow multiple callbacks : This toggle will tell LoopBack whether
  401.            or not it should callback numbers that have already been called
  402.            back.  (LoopBack will still read in the "already used number"
  403.            trash file and will still update it, but it will call the user
  404.            back even if it finds a record matching the user's phone #)
  405.  
  406.      (16)  Allow trash file display : This toggle will tell LoopBack whether
  407.            or not to display the trash file information to the user if a 
  408.            record was found matching the user's phone number.  The user will
  409.            be shown the caller that was called back with the matching # and
  410.            the date & time of the callback. 
  411.  
  412.      (17)  Place to put date comment (Comment #1) : This toggle will tell 
  413.            LoopBack where it should put the date comment (if configured to
  414.            use the date comment).  In the configuration (LoopUtil) you will
  415.            be given a menu of choices.  This comment can be placed in either
  416.            of the 2 user record comment fields or any of the 5 Notes PSA 
  417.            fields (If Notes PSA is installed).
  418.  
  419.      (18)  Place to put phone # comment (Comment #2) : This toggle will tell
  420.            LoopBack where it should put the phone # comment (if configured to
  421.            use the phone # comment).  In the configuration (LoopUtil) you will
  422.            be given a menu of choices.  This comment can be placed in either
  423.            of the 2 user record comment fields or any of the 5 Notes PSA
  424.            fields (If Notes PSA is installed).
  425.  
  426.      (19)  Filetype to execute at the end : This toggle will tell LoopBack
  427.            what kind of file (if any) it should execute after the user has
  428.            been verified, but before the user is upgraded.  (P)pe will tell
  429.            LoopBack to call a PPE file.  (B)atch will tell LoopBack to execute
  430.            a DOS Batch file.  (N)one will tell LoopBack to not execute a file
  431.            at all.  (The file to execute may be configured under the
  432.            configuration paths)
  433.  
  434.      (20)  Do not allow broadcast messages : This toggle will tell LoopBack 
  435.            whether or not to allow the user to receive broadcast messages 
  436.            from other nodes.  If set to Yes, LoopBack will modify the 
  437.            USERNET.XXX file to prevent the user from receiving a broadcast
  438.            message.  If set to No, LoopBack will not modify the USERNET.XXX
  439.            status flag.
  440.       
  441.      (21)  Hangup on bad numbers : This toggle will tell LoopBack whether or
  442.            not it should hang up on the user if he/she enters a number that 
  443.            was found in the Bad #'s file.  If set to Yes, LoopBack will hangup
  444.            on the user..  If set to No, LoopBack will simply return back to
  445.            the BBS.
  446.      
  447.      (22)  Immediately start download : This toggle will tell LoopBack whether
  448.            or not it should immediately start the download process after it
  449.            flags the files for download.  You may wish to do this if your new
  450.            users tend to logoff without downloading the files that were 
  451.            flagged.  NOTE: If LoopBack is supposed to logoff the user after
  452.            callback, it will NOT attempt to flag a file for download, nor 
  453.            will it attempt to initiate the download process.
  454.  
  455.      (23)  Check Caller-ID string : This toggle will tell LoopBack whether or 
  456.            not it should search for the user's home and/or data numbers in the
  457.            caller id string.  If either number is found, LoopBack will upgrade
  458.            the user according to the default settings in the Configuration
  459.            settings (Default Sec. Lvl if no callback, Default Exp. Sec. Lvl,
  460.            etc.) and it will exit back to PCBoard without calling the user
  461.            back.  If either number is not found in the caller-id string, it 
  462.            will proceed as normal.
  463.  
  464.  
  465.       Configuration Settings
  466.      ------------------------
  467.       (1)  Modem dialstring : This setting will tell LoopBack the dialstring
  468.            to use when calling the user back.  If you have touchtone dialing,
  469.            then set this setting to ATDT.  If you have pulse dialing, set it
  470.            to ATDP.
  471.  
  472.       (2)  Number dialing prefix : This setting will tell LoopBack the prefix
  473.            to dial before it dials the number.  This can be used if you need
  474.            to dial 9 to get out, etc.  If this setting is not needed, do not
  475.            set it equal to anything.
  476.  
  477.       (3)  Number dialing suffix : This setting will tell LoopBack the number
  478.            to dial after it dials the number.  I personally cannot think of
  479.            any use for this, but if you find one, please tell me.
  480.  
  481.       (4)  Maximum # of redial attempts : This setting will tell LoopBack the
  482.            maximum # of times that it will try to redial the number if a 
  483.            connection is not made the first time.  If LoopBack still does not
  484.            connect after it redials the maximum # of times, it will exit back
  485.            to PCBoard.
  486.  
  487.       (5)  Maximum # of ticks to wait for connection : This setting will tell
  488.            LoopBack the maximum # of ticks that it should wait for a 
  489.            connection.  (The term ticks and its conversion factor to seconds 
  490.            is defined in the explanation section later in the manual)
  491.  
  492.       (6)  Amount of time to adjust : This setting will tell LoopBack the 
  493.            amount of time in which to adjust the user's time.  (To configure
  494.            how to adjust the time, see configuration toggles)
  495.  
  496.       (7)  Modem initialization string before callback : This setting will 
  497.            tell LoopBack the string in which to send to the modem (to 
  498.            initialize it) before it dials the number.
  499.  
  500.       (8)  Maximum # of ticks to wait for hangup : This setting will tell 
  501.            LoopBack the maximum # of ticks to wait for the modem to hangup on
  502.            the user.  NOTE: As soon as LoopBack detects a carrier loss, it 
  503.            will go on to initialize the modem, dial the number, etc.
  504.  
  505.       (9)  Long distance access string : This setting will tell LoopBack the
  506.            string to dial before it calls a long distance, toll call, or 
  507.            International number.  For example, to use AT&T you would set this
  508.            equal to 102881.  If you just want to use 1+ dialing and no 
  509.            special LD company, set it equal to 1.  You can specify when to
  510.            use this in dialing templates maintenance.
  511.  
  512.      (10)  Minimum # of digits to dial : This setting will tell LoopBack the 
  513.            minimum # of digits allowed in the callback #.  For example, if 
  514.            you set this equal to 10 and the user enters a number like 
  515.            212-77-022, then LoopBack will tell them that it does not contain
  516.            enough digits and reask the user for the callback number.
  517.  
  518.      (11)  Default Exp. Lvl. if no callback : This setting will tell LoopBack
  519.            the value to put in place of the user's expired security level if
  520.            no callback occurs.  (Not in allowed # calling file, # found in
  521.            caller-id string, timetables, etc.)  A setting of 0 will tell 
  522.            LoopBack not to touch the user's expired security level.
  523.  
  524.      (12)  Default days till expire if no callback : This setting will tell
  525.            LoopBack the number of days to add to the verification date to 
  526.            replace the user's expiration date.  For example, if you enter
  527.            30 in this field, and the date that the user entered LoopBack was
  528.            12-01-94, then the user's new expiration date (if he/she was not
  529.            called back) will be 12-31-94.
  530.  
  531.      (13)  Default Sec. level if no callback : This setting will tell LoopBack
  532.            the value to put in place of the user's security level if no 
  533.            callback occurs.  (Not in allowed # calling file, # found in 
  534.            caller-id string, timetables, etc.)  A setting of 0 will tell 
  535.            LoopBack not to touch the user's security level.
  536.  
  537.      (14)  Maximum # of name input tries : This setting will tell LoopBack the
  538.            maximum number of times to allow the user to enter his/her name 
  539.            for verification.  If the user does not enter a valid name in the
  540.            maximum # of tries, then LoopBack will issue the BYE command and
  541.            will exit back to PCBoard.
  542.  
  543.      (15)  Maximum # of password input tries : This setting will tell LoopBack
  544.            the maximum number of times to allow the user to enter his/her 
  545.            password for verification.  If the user does not enter a valid
  546.            password in the maximum number of tries, then LoopBack will issue
  547.            the BYE command and will exit back to PCBoard.
  548.  
  549.      (16)  Maximum # of verification string input tries : This setting will
  550.            tell LoopBack the maximum number of times to allow the user to 
  551.            enter his/her verification string for verification.  If the user
  552.            does not enter a valid verification string in the maximum number
  553.            of tries, then LoopBack will issue the BYE command and will exit
  554.            back to PCBoard.
  555.  
  556.      (17)  Maximum # of city input tries : This setting will tell LoopBack the
  557.            maximum number of times to allow the user to enter his/her city
  558.            for verification.  If the user does not enter a valid city in the
  559.            maximum number of tries, then LoopBack will issue the BYE command
  560.            and will exit back to PCBoard.
  561.  
  562.      (18)  Maximum # of hangup attempts : This setting will tell LoopBack the
  563.            maximum number of times to try to hangup the modem.  If a carrier
  564.            is still detected after LoopBack has tried to hangup for the 
  565.            maximum # of attempts, then LoopBack will issue the BYE command and
  566.            exit back to PCBoard.
  567.  
  568.      (19)  Time delay after connection : This setting will tell LoopBack the
  569.            # of ticks to delay after a connection is detected.  
  570.  
  571.      (20)  Your BBS line's areacode : This setting will tell LoopBack the 
  572.            default areacode to put in the areacode field when asking the user
  573.            for their phone number.  (If the user did not pick their home or
  574.            data number) If you do not wish to provide your users with a 
  575.            default, then do not set this equal to anything.
  576.  
  577.      (21)  Number of minutes to add on entry : This setting will tell LoopBack
  578.            the # of minutes to add to the user's time upon entry of LoopBack.
  579.            If your newusers may not have enough time to undergo the 
  580.            verification process, then LoopBack will add the number of minutes
  581.            defined in this setting to their time..  This will help to give 
  582.            them enough time to be verified.
  583.  
  584.      (22)  Daily download bytes to add.  Set this equal to the # of bytes to 
  585.            add to the number of bytes the user has already downloaded for the 
  586.            current day. ie., a setting of 100000 will let LoopBack tell PCBoard 
  587.            that the user has already downloaded 100,000 bytes for the current 
  588.            day.  (Thus indicating that he/she can download 100,000 less bytes
  589.            than before verification.  To let the user download more bytes for 
  590.            the current day, use a negative number.  ie, a setting of -100000 
  591.            will let LoopBack tell PCBoard that the user can download 100,000 
  592.            more bytes for the current day.
  593.  
  594.      (23)  Total download bytes to add.  Set this equal to the # of bytes to 
  595.            add to number of total bytes the user has already downloaded since 
  596.            his/her first logon date.  ie., a setting of 100000 will let 
  597.            LoopBack tell PCBoard that the user has already downloaded 100,000 
  598.            bytes since his/her first logon date.  (Thus indicating that he/she
  599.            can download 100,000 less bytes than before verification.) To let 
  600.            the user download more bytes, a setting of -100000 will let LoopBack 
  601.            tell PCBoard that the user can download 100,000 more bytes.
  602.  
  603.      (24)  Total files to add.  Set this equal to the # of files to add to the 
  604.            number of total files the user has downloaded since his/her first 
  605.            logon date.  ie., a setting of 10 will let LoopBack tell PCBoard 
  606.            that the user has already downloaded 10 files since his/her first 
  607.            logon date.  (Thus indicating that he/she can download 10 less 
  608.            files than before verification.)  To let the user download more
  609.            files, a setting of -10 will let Loopback tell PCBoard that the user 
  610.            can download 10 more files.
  611.  
  612.       
  613.       Configuration Paths
  614.      ---------------------
  615.       (1)  Trash can file : This is the path & filename of the file that 
  616.            LoopBack should use to search for phone numbers that have already 
  617.            been called back.
  618.  
  619.       (2)  Allowed # calling file : This is the path & filename of the file 
  620.            that LoopBack should use to determine whether or not it is allowed
  621.            to call back the number that the user entered.  (This file is 
  622.            explained later in the documentation.
  623.  
  624.       (3)  User name trash file : This is the path & filename of the file 
  625.            that LoopBack should search to determine whether or not the user
  626.            is allowed to enter LoopBack.
  627.  
  628.       (4)  Bad numbers file : This is the path & filename of the file that 
  629.            LoopBack should use to determine whether or not the number it is 
  630.            about to call is a bad number number.
  631.  
  632.       (5)  SysOp message file : This is the path & filename of the file that
  633.            LoopBack should send to the SysOp as a message after a successful
  634.            callback.  LoopBack will not use this file if the message to send
  635.            to the SysOp has been configured as an Internal message or no
  636.            message at all.
  637.  
  638.       (6)  User message file : This is the path & filename of the file that
  639.            LoopBack should send to the user as a message after a successful
  640.            callback.  LoopBack will not use this file if the message to send 
  641.            to the user has been configured as an Internal message or no 
  642.            message at all.
  643.      
  644.       (7)  Numbers menu file : This is the path & filename of the menu
  645.            displayed to the user when he/she is selecting the number to use
  646.            for callback.  
  647.  
  648.       (8)  Help file : This is the path & filename of the help file displayed 
  649.            to the user when he/she selects the (H)elp command from the LoopBack
  650.            main menu.
  651.  
  652.       (9)  Locking timetable : This is the path & filename to the file that
  653.            LoopBack will use to determine whether or not it should be 
  654.            operating at the time.
  655.  
  656.      (10)  Security trashfile : This is the path & filename to the file that
  657.            LoopBack should search to determine if the user's security level
  658.            is allowed to enter LoopBack.
  659.  
  660.      (11)  File to flag for user : This is the path & filename of the file 
  661.            that LoopBack should flag for download after a successful callback.
  662.            If you do not wish to have LoopBack flag a file for download, then
  663.            do not set this equal to anything.
  664.  
  665.      (12)  File to execute upon verification : This is the path & filename
  666.            of the file that LoopBack should execute after the user has been
  667.            verified, but before the user is upgraded.  (The file type to
  668.            execute is defined in configuration toggles)
  669.  
  670.       
  671.       Registration Information
  672.      --------------------------
  673.       
  674.       The following registration information is only required to be entered
  675.       when LoopBack has been registered.
  676.       
  677.       (1)  SysOp name : This is the SysOp's name that registered LoopBack.
  678.  
  679.       (2)  Registration # : This is the registration # given to the SysOp
  680.            after he/she registered LoopBack.
  681.  
  682.       (3)  Date + time registered : This is the date + time registered value
  683.            given to the SysOp after he/she registered LoopBack.
  684.  
  685.       (4)  Version registered : This is the version # that was given to the
  686.            SysOp when he/she registered LoopBack. This is NOT the version
  687.            of LoopBack that you are running!
  688.  
  689. ------------------------------------------------------------------------------
  690. Environment Switches:
  691. ----------------------
  692.  
  693.       In addition to all the configuration toggles and settings, LoopBack 
  694.       contains some additional configurability with the use of Environment
  695.       switches.  Environment switches are very simply to use.  All you do is
  696.       place them in your BOARD.BAT file, and your off.  The variable name to
  697.       use is LOOPBACK.  Each node's board.bat must be modified for the changes 
  698.       to take affect for all nodes.  ie.,
  699.  
  700.         SET LOOPBACK=/ALERT /BYPASS
  701.  
  702.       The above is an example of the use of environment switches.  By placing
  703.       that line at the top of your BOARD.BAT file, you will turn on the bad
  704.       number alarm, and bypass the main menu upon entry.
  705.  
  706.       Here is a listing of all the possible environment switches:
  707.  
  708.               /ALERT  --  Will sound a 5 second siren whenever the user enters
  709.                           a number that was found in the bad number files.
  710.                           Will also display a message on screen to the SysOp
  711.                           that only the SysOp will be able to see.
  712.  
  713.           /LOCALONLY  --  Only allow local users in LoopBack.  (For testing
  714.                           purposes before you actually put it online.)
  715.  
  716.              /NOINFO  --  Do not allow the caller to view the (L)oopinfo
  717.                           screen.  (You may also wish to edit the prompt so 
  718.                           that it no longer contains the (L)oopInfo selection.  
  719.                           It is prompt #15.)
  720.  
  721.              /BYPASS  --  This environment switch will tell LoopBack to bypass 
  722.                           the LoopBack main menu and go directly into the 
  723.                           callback process.  
  724.  
  725.       So, if you were to configure a node on your system to sound the bad #
  726.       alert, bypass the main menu, and disallow the (L)oopInfo screen viewing,
  727.       your BOARD.BAT for that particular node might look like the following:
  728.  
  729.          ECHO OFF
  730.  
  731.          C:
  732.          CD \PCB\NODE1
  733.          SET PCB=
  734.          SET DSZLOG=PCBDSZ.LOG
  735.          SET LOOPBACK=/ALERT /BYPASS /NOINFO
  736.  
  737.          IF EXIST REMOTE.BAT RENAME REMOTE.BAT REMOTE.SYS
  738.          IF EXIST DOOR.BAT DEL DOOR.BAT
  739.          IF EXIST ENDPCB DEL ENDPCB
  740.  
  741.          PCBOARDM
  742.  
  743.          IF EXIST REMOTE.BAT REMOTE
  744.          IF EXIST DOOR.BAT DOOR
  745.          IF EXIST EVENT.BAT EVENT
  746.          IF EXIST ENDPCB GOTO END
  747.          BOARD
  748.  
  749.          :END
  750.          exit
  751.  
  752.       If you will be using multiple environment switches, they should be 
  753.       seperated by a space (as shown above).  If you would only like to bypass
  754.       the LoopBack main menu, your LoopBack environment variable might look like
  755.       this:
  756.           
  757.          SET LOOPBACK=/BYPASS
  758.  
  759.       
  760. ------------------------------------------------------------------------------
  761. Statistics file maintenance via LoopUtil:
  762. -----------------------------------------
  763.            
  764.       The statistics file holds information for the last 6 callbacks and the
  765.       total number of callbacks.  The only time that you will want to edit 
  766.       this file is when you want to reset the stats file or change either
  767.       one of the last 6 callbacks or the total # of callbacks.
  768.  
  769. ------------------------------------------------------------------------------
  770. Prompt file maintenance via LoopUtil:
  771. -------------------------------------
  772.  
  773.       The prompt file is somewhat like PCBoard's own PCBTEXT file with a few
  774.       differences..  First, you can actually "turn off" a prompt in LoopBack.
  775.       Second, you can tell LoopBack whether or not to add a linefeed before 
  776.       the prompt is displayed, etc.
  777.  
  778.       To search for a prompt : Type P from the LoopUtil main menu...  After 
  779.                                entering the full path & filename of the 
  780.                                prompt you want to edit, type S.  Then enter
  781.                                your search criteria. (Since this is a BOYER - 
  782.                                MOORE search you can enter criteria with the
  783.                                && and || symbols.  As well as parentheses 
  784.                                enclosure, etc.)  
  785.  
  786.                                LoopUtil will then search for the prompt.  If
  787.                                found it will display the prompt's record and
  788.                                halt the search.  If not found, you will be 
  789.                                returned to the record you were editing when
  790.                                you initiated the search.
  791.       
  792.       To change a prompt : Type P from the LoopUtil main menu...  Then you 
  793.                            must enter the full path & filename of the prompt
  794.                            file that you want to edit...
  795.  
  796.                            After the prompt module is loaded, find the prompt
  797.                            you want to edit and type P to change the prompt.
  798.                            Then, just type your text and hit return..
  799.  
  800.       To change a prompt to a PPE file or Display file : Do exactly the same
  801.       as you would in PCBoard.   For example, this would execute the file 
  802.       DOSUM.PPE (!C:\PCB\PPE\DOSUM.PPE).  The following would display the file 
  803.       OK. (%C:\PCB\PPE\OK).  The Type field in the prompt editor is not used 
  804.       by LoopBack and is there for informational purposes only.  So if you 
  805.       change a prompt to a PPE file, you do not have to update the Type, but 
  806.       you can so that you will know it is a PPE file.
  807.  
  808.       To turn off a prompt : Typing U from the prompt editor will toggle the
  809.                              Utilize Prompt flag.   
  810.                              
  811.       To add a linefeed before the prompt : Typing L in the prompt editor 
  812.                                             toggle the linefeed flag.
  813.  
  814.       For more information on replacing prompts with display files and PPE
  815.       files, see the PCBoard manual.
  816.       
  817. ------------------------------------------------------------------------------
  818. Already used number trashcan file maintenance via LoopUtil:
  819. -----------------------------------------------------------
  820.  
  821.       The already used number trashcan holds the numbers that have already 
  822.       been called back.  If you have the Multiple Callbacks toggle toggled 
  823.       to Yes, then you can disregard this part of the manual.
  824.  
  825.       
  826.       Converting the trashfile
  827.      --------------------------
  828.       If you are just now upgrading from a release prior to v1.07, then 
  829.       please read this section carefully.
  830.  
  831.       In v1.07 of LoopBack, the already used number trash file format was 
  832.       changed.  You will need to convert your old format to the new 1.07
  833.       specifications.  Please type N at the LoopUtil main menu, then type 
  834.       C at the next menu to convert the file.  After the conversion, you may
  835.       wish to go through your already used number trash file and edit any
  836.       records that seem to be missing leading zeros.  (For a definition of 
  837.       leading zeros, please see the explanation section of this manual)
  838.       This new file format fixes the problem of LoopBack not recognizing 
  839.       leading zeros in versions prior to v1.07.  An example of a number that
  840.       may be missing some leading zeros:
  841.  
  842.          Original number :  212-777-0225
  843.          Number in file  :  212-777-225
  844.  
  845.       Notice the zero is gone...
  846.       
  847.       
  848.       Building the trashfile
  849.      -----------------------
  850.       If you are switching call-back verifier's to LoopBack and/or you are 
  851.       installing LoopBack for the first time, then you will probably wan to
  852.       BUILD your already used number trash can
  853.  
  854.       LoopUtil will either BUILD a new trash can file or it will add to your
  855.       existing trash file.  LoopUtil will add records by security level also.
  856.  
  857.       IMPORTANT NOTES: LoopUtil will NOT add a number to the trash file if it
  858.       does not contain at least 10 numbers or if it contains MORE than 10 
  859.       numbers.  LoopUtil strips out all characters except numbers and then 
  860.       determines if the number is in the correct format or not. (AREACODE +
  861.       PREFIX + OTHER 4 NUMBERS)  LoopUtil will also keep a log file called 
  862.       BUILD.RPT.  This file contains the user's name that met the security 
  863.       level requirement, the user's record number, whether or not the user's
  864.       DATA number was added to the trash file, the user's DATA number, 
  865.       whether or not the user's HOME number was added to the trash file, and
  866.       the user's HOME number.  You may wish to print out this file after you
  867.       are done building the trash file.  You can look at each number that
  868.       was not added to the trash file and add it manually within LoopUtil. It's
  869.       all in the log file.  LoopBack also backs up your already used number
  870.       trash file.  The backup file is located in your LoopUTIL directory and
  871.       the filename is TRASH.BAK.  If something should go wrong during the
  872.       trash file building process, then all you have to do is delete your 
  873.       trash file and replace it with the backup.
  874.       
  875.       Add to the trash file or build a new one?   If you are running LoopBack
  876.       for the first time, then I would tell you to build a new one.  If you
  877.       have been running LoopBack for awhile and just now found the BUILD 
  878.       feature, then let LoopUtil add to the trash file.
  879.  
  880.       (L)owest security level to process  :  This is the lowest security level
  881.       of the users that you want LoopBack to import into the already used #
  882.       trash file.
  883.  
  884.       (H)ighest security level to process :  This is the highest security 
  885.       level of the users that you want LoopBack to import into the already 
  886.       used # trash file.
  887.  
  888.       (U)sers file path & filename  : This is the path & filename of your 
  889.       USERS. file.  There should be no need to change this, as LoopBack 
  890.       extracts the information directly from your PCBOARD.DAT file.
  891.  
  892.       
  893.       When LoopUtil finds a user record that meets the security level and
  894.       fluctuation requirements, then that user will be added to the log file
  895.       and if his/her DATA number is the correct format (10 characters/numbers)
  896.       then it will be added.  Also, if the user's HOME number is the correct
  897.       format, it will be added to the trash file.
  898.  
  899.       IF YOU ARE ADDING TO THE TRASH FILE AND NOT BUILDING A NEW ONE, I
  900.       RECOMMEND THAT YOU PACK IT FIRST.
  901.  
  902.       THIS IS AN AWFULLY SLOW PROCESS!  IT IS SUGGESTED THAT ALL NODES ARE
  903.       TAKEN DOWN DURING THIS PROCESS...  (Although not required, it may 
  904.       slow down your computer if you are multi-tasking)  Also, the more 
  905.       overlay buffers that you have, the faster it works.
  906.  
  907.  
  908.       Indexing the trashfile
  909.      ------------------------
  910.       LoopBack has an index file for the trash file.  It uses this index file
  911.       when searching for numbers that have already been used.  LoopBack will
  912.       NOT operate correctly without this file..   That's why you have to 
  913.       create it..
  914.  
  915.       To index the trash file, type N from the LoopUtil main menu, then type
  916.       I at the next menu.  This will start the indexing process and LoopUtil
  917.       will automatically extract the information from the already used # 
  918.       trash file and place it into the TRASH.IDX file.
  919.       
  920.       Exporting the trash file to a text file
  921.      -----------------------------------------
  922.         When exporting, LoopUtil will ONLY export numbers that are not 
  923.         international numbers.  It will place those numbers that were not 
  924.         exported in the report file so that you may add them yourself
  925.         
  926.         You must first type N from the LoopUtil main menu.  At the next menu,
  927.         you need to type X to invoke the used # trash MODULE in EXPORT mode.
  928.         LoopUtil will then ask you for the path & filename of the text file to
  929.         export to.  After that, you must enter the path & filename of the 
  930.         file to use as your report file.  After this, LoopUtil will begin its
  931.         exporting process.
  932.  
  933.       
  934.       Importing a text file into the trash file
  935.      -------------------------------------------
  936.         When importing, LoopUtil will ONLY import numbers that are of the 
  937.         following format:  XXX-XXX-XXXX   In other words, LoopUtil will only
  938.         import American and Canadian phone numbers.  212-777-0225 will work,
  939.         but 34-545-987678 will not work.
  940.         
  941.         You must first type N from the LoopUtil main menu.  At the next menu,
  942.         you need to type M to invoke the used # trash MODULE in IMPORT mode.
  943.         LoopUtil will then ask you for the path & filename of the text file to
  944.         import.  After that, you must enter the default username that will be
  945.         placed in all records that are imported.  After this, LoopUtil will
  946.         begin its importing process.
  947.  
  948.         Text file format is as follows:
  949.          
  950.          EACH LINE : 212-777-0225  
  951.          OR        : 2127770225
  952.          OR        : (212)777-0225
  953.          OR        : (212) 777-0225
  954.          OR        : 212 777-0225
  955.          ETC., ETC.
  956.  
  957.          LoopUtil will strip out the following characters: ( ) - , 
  958.          It will also strip out spaces...
  959.  
  960.          There must be only one number per line!  A text file to import may
  961.          look something like this:
  962.           
  963.                212-777-0225
  964.                801-261-8976
  965.                801-261-8979
  966.                801-261-1686
  967.  
  968.       
  969.       Editing the trashfile
  970.      -----------------------
  971.       Searching for a record : To search for specific text in the Name field
  972.       of a record, type S from the trashcan editor.  Then you must enter your
  973.       search criteria.  (BOYER-MOORE search format)  If LoopUtil finds your
  974.       text in the name field of one of the records, that record will be 
  975.       displayed and the search will halt.  If LoopUtil does not find your
  976.       search criteria, you will be returned to the record in which you were
  977.       editing.
  978.       
  979.       Deleting a record : To delete a record, type E from the trashcan 
  980.       editor and that will toggle the delete flag.  This will only "turn the
  981.       record off".  In other words, LoopBack will ignore this record when 
  982.       searching for a duplicate phone number.  To physically delete the 
  983.       record, see "Packing the trashfile".
  984.                                                 
  985.       Adding a record : To add a record, type A from the trashcan editor.
  986.       You will then be asked a series of questions, and as soon as you finish
  987.       entering all the information, you will be returned to the editor.
  988.  
  989.       Changing the username called back : To change the name, type N from the
  990.       trashcan editor.  This field is not case sensitive since LoopBack 
  991.       automatically changes it to uppercase.
  992.  
  993.       Changing the number called : To change the number that was called back,
  994.       type # from the trashcan editor.  If you have the international toggle
  995.       set to yes, then LoopBack will ask you for the country code, city code,
  996.       etc.  If the international toggle is set to no, then LoopBack will ask
  997.       for the areacode, prefix, & number.
  998.  
  999.       Changing the international toggle : To change the international toggle,
  1000.       type I from the trashcan editor.  
  1001.  
  1002.       Changing the date called back : To change the date called back, type D
  1003.       from the trashcan editor.
  1004.  
  1005.       Changing the time called back : To change the time called back, type T
  1006.       from the trashcan editor.
  1007.  
  1008.       Packing the trashfile
  1009.      -----------------------
  1010.       To pack the already used number trashcan file, type N from the LoopUtil
  1011.       main menu.  Then, when asked whether you want to pack or edit the 
  1012.       trashfile, type P.  After that, LoopUtil will ask you if you want to 
  1013.       check the trash file against the PCBoard USERS file for validity.  If
  1014.       you select Y for this option, it will go through each trash file record
  1015.       and search the PCBoard USERS file to make sure that user still exists
  1016.       on the system.  If the user does not exist in the PCBoard USERS file,
  1017.       LoopUtil will mark that user for deletion from the LoopBack trash file 
  1018.       and he/she will be packed out.  If you select N for this option, it 
  1019.       will not check the LoopBack trash file against the PCBoard USERS file 
  1020.       for validity.  LoopUtil will then show the filesize of the trash file
  1021.       and the number of records in the trashfile.  It will also display a
  1022.       percentage bar and percent done while it is packing the trashfile.
  1023.       Packing the trashfile will remove all records that have the Delete
  1024.       flag set to Yes.
  1025.  
  1026.       NOTE: If you elect to check the trash file against the PCBoard USERS 
  1027.       file for validity, a file called COMPARE.RPT will be created in your
  1028.       LoopBack directory.  This file will contain the names of all the 
  1029.       users that were removed from your LoopBack trash file.
  1030.  
  1031. ------------------------------------------------------------------------------
  1032. Timetable maintenance via LoopUtil:
  1033. -----------------------------------------------------------
  1034.  
  1035.       These timetables control the times that LoopBack is allowed to operate
  1036.       and callback using your specific dialing templates.  With these 
  1037.       timetables, you can set the dates, times & nodes to lock and to unlock 
  1038.       these functions from use.
  1039.       
  1040.       Editing the timetables
  1041.      ------------------------
  1042.       When editing the timetables, you must first select the timetable that
  1043.       you would like to edit.  (If editing a dialing template timetable, you
  1044.       must specify the name of the dialing template)
  1045.  
  1046.       Deleting a record : To delete a record from the timetable, type D to
  1047.       toggle the delete flag.
  1048.  
  1049.       Adding a record : To add a record, type A from the timetable editor.
  1050.       After you enter all the information, the record is saved to the 
  1051.       timetable file.
  1052.  
  1053.       Changing the node affected : To change the node affected, type N from
  1054.       the timetable editor and type the node # in which you would like the
  1055.       record to affect.  If you select 0 as the node number, the record you
  1056.       are editing will affect all nodes.
  1057.  
  1058.       Changing the date to lock : To change the date to lock, type 1 from 
  1059.       the timetable editor and type the new date to lock.  If you set the 
  1060.       date to lock field equal to 0 then LoopBack will assume that you don't
  1061.       care what date it is and will look at the time field.  
  1062.  
  1063.       Changing the time to lock : To change the time to lock, type 2 from
  1064.       the timetable editor and type the new time to lock.  If you set the
  1065.       time to lock field equal to 0 and the date to lock field equal to 0
  1066.       then LoopBack will ignore the record and go on to the next.
  1067.  
  1068.       Changing the date to unlock : This works the same way as the date to
  1069.       lock, but you type 3 to access it.
  1070.  
  1071.       Changing the time to unlock : This works the same way as the time to
  1072.       lock, but you type 4 to access it.
  1073.  
  1074.       The two different timetables you can edit are:
  1075.        
  1076.         Locking timetable : This timetable tells LoopBack what time to not
  1077.                             allow users to use LoopBack and what time to 
  1078.                             "unlock" and allow users to use LoopBack.
  1079.  
  1080.         Dialing template timetable : This allows you to specify a seperate 
  1081.                                      timetable for each of your dialing 
  1082.                                      templates.  These timetables tell 
  1083.                                      LoopBack what time to allow callback 
  1084.                                      utilizing the specific dialing tempalte.
  1085.                                      (Dialing templates are discussed later 
  1086.                                      in the manual.)
  1087.         
  1088.         The filename for the locking timetable is defined in the configuration
  1089.         paths.  The filenames for the dialing template timetables are as
  1090.         follows:
  1091.                    <TPLTNAME>.TBL
  1092.  
  1093.         <TPLTNAME> = The first 8 characters of the template name.
  1094.  
  1095.  
  1096.       Packing the timetables
  1097.      ------------------------
  1098.         To pack the timetables, select the Timetable option from LoopBack, 
  1099.         then select Pack timetables.  You will then need to specify which
  1100.         timetable you want to pack.  While LoopUtil is packing the timetables,
  1101.         it will display a percentage bar and percent done on the screen so
  1102.         you will have an idea when the packing procedure will end.
  1103.  
  1104. ------------------------------------------------------------------------------
  1105. Bad number file maintenance via LoopUtil:
  1106. -----------------------------------------
  1107.  
  1108.         The bad number file is the file where you specify which numbers 
  1109.         that you do NOT want to be called back.  You can specify whether or
  1110.         not the number is an international number..  Wildcards can also be
  1111.         specified for each field in the number. (Areacode, Prefix, etc.)
  1112.  
  1113.         (See section on wildcards later in the manual for more information)
  1114.  
  1115.       Exporting the bad number file to a text file
  1116.      ----------------------------------------------
  1117.         When exporting, LoopUtil will ONLY export number that are not 
  1118.         international numbers.  All numbers not exported will be placed in 
  1119.         the report file so that you can add them manually.
  1120.  
  1121.         You must first type B from the LoopUtil main menu.  At the next menu,
  1122.         you need to type X to invoke the Bad Number MODULE in EXPORT mode.
  1123.         LoopUtil will then ask you for the path & filename of the text file to
  1124.         export to.  After that, you must enter the path & filename of the 
  1125.         file to use for your report file.  Then, LoopUtil will begin its 
  1126.         exporting process.
  1127.  
  1128.  
  1129.       Importing a text file into the bad number file
  1130.      ------------------------------------------------
  1131.         When importing, LoopUtil will ONLY import numbers that are of the 
  1132.         following format:  XXX-XXX-XXXX   In other words, LoopUtil will only
  1133.         import American and Canadian phone numbers.
  1134.         
  1135.         You must first type B from the LoopUtil main menu.  At the next menu,
  1136.         you need to type I to invoke the Bad Number MODULE in IMPORT mode.
  1137.         LoopUtil will then ask you for the path & filename of the text file to
  1138.         import.  After that, you must enter the default node affected that 
  1139.         LoopUtil will put in all records that are imported.  Then, LoopUtil will
  1140.         begin its importing process.
  1141.  
  1142.         Text file format is as follows:
  1143.          
  1144.          EACH LINE : XXX-XXX-XXXX  
  1145.          OR        : XXXXXXXXXX
  1146.          OR        : (XXX)XXX-XXXX
  1147.          OR        : (XXX) XXX-XXXX
  1148.          OR        : XXX XXX-XXXX
  1149.          ETC., ETC.
  1150.  
  1151.          LoopUtil will strip out the following characters: ( ) - , 
  1152.          It will also strip out spaces...
  1153.  
  1154.          There must be only one number per line!  A text file to import may
  1155.          look something like this:
  1156.           
  1157.                212-777-0225
  1158.                XXX-555-1212
  1159.                XXX-XXX-911
  1160.                XXX-911-XXXX
  1161.                911-XXX-XXXX
  1162.  
  1163.  
  1164.       Editing the bad number file
  1165.      -----------------------------
  1166.         Deleting a record : Type D from the bad number editing menu.  This
  1167.         will toggle the delete flag.
  1168.  
  1169.         Adding a record : Type A from the bad number editing menu.  You will
  1170.         then be asked a series of questions and after you enter all the 
  1171.         information then the the record will be saved to disk and you will 
  1172.         be returned to the editor.
  1173.  
  1174.         Toggling the International flag : If you wish to toggle the 
  1175.         international flag, type I from the editor menu.  
  1176.  
  1177.         Changing the node # affected : If you wish to change the node # that
  1178.         this record affects, type O from the editor menu.  If you specify 0 
  1179.         as the node # affected, then LoopBack will assume that you want this
  1180.         record to affect ALL nodes.
  1181.         
  1182.         Changing the number : If you have the international flag toggled to 
  1183.         yes, then LoopUtil will ask you for the country code, city code, and 
  1184.         number.  If you have the international flag set to no, then LoopUtil 
  1185.         will ask you for the areacode, prefix, and number.  
  1186.  
  1187.       Packing the bad number file
  1188.      -----------------------------
  1189.         To pack the bad number file, select Bad number file maintenance from
  1190.         the LoopUtil main menu..  Then tell LoopUtil that you want to Pack the
  1191.         file.  After all this is completed, LoopUtil will remove all records
  1192.         that have the delete flag set to yes.
  1193.  
  1194. ------------------------------------------------------------------------------
  1195. Name & security trash file maintenance via LoopUtil:
  1196. ----------------------------------------------------
  1197.  
  1198.         The name trash file will be searched everytime LoopBack is loaded.
  1199.         If the file exists, then LoopBack will not allow a user with a name
  1200.         found in this file to enter LoopBack.
  1201.  
  1202.         The security trash file will be searched everytime LoopBack is loaded.
  1203.         If the file exists, then LoopBack will not allow a user with a 
  1204.         security level that is found in this file to enter LoopBack.
  1205.  
  1206.       Exporting the trash files to a text file
  1207.      ------------------------------------------
  1208.         To one of the trash file databases to a text file, type F at the 
  1209.         LoopUtil main menu.  At the next menu, type X to invoke the Name &
  1210.         security trash file MODULE in EXPORT mode.  Then, you must select 
  1211.         which trash file that you would like to export.  After that, you must 
  1212.         enter the path & filename of the text file to export to.  Then, 
  1213.         LoopUtil will begin the exportation process.
  1214.       
  1215.       Importing a text file into the trash files
  1216.      --------------------------------------------
  1217.         To import a text file into one of the trash file databases, type F
  1218.         at the LoopUtil main menu.  At the next menu, type I to invoke the
  1219.         Name & security trash file MODULE in IMPORT mode.  After that, 
  1220.         select which trash file that you would like to import to.  LoopUtil
  1221.         will then ask you for the filename of the text file that you would
  1222.         like to import into the trash file.  After that, you must enter the
  1223.         node affected for all imported records.  (0 will tell LoopUtil that
  1224.         it affects all nodes)  Then, LoopUtil will begin the importation 
  1225.         process.
  1226.  
  1227.         Text file format for Username importation:
  1228.             
  1229.                Each line must contain the name or name subset that you would
  1230.                like imported to the username trash file.  ie.
  1231.                 
  1232.                Your text file might look like this:
  1233.                 
  1234.                     BOB WATSON
  1235.                     JOHN DOE
  1236.                     SysOp
  1237.  
  1238.                     The first two are obvious, but the 3rd entry will deny 
  1239.                     access to anyone that has the word SysOp anywhere in
  1240.                     their name
  1241.  
  1242.         Text file format for Security importation:
  1243.           
  1244.                Each line must contain the security level that you would like   
  1245.                imported to the security trash file.  ie.
  1246.  
  1247.                Your text file might look like this:
  1248.  
  1249.                     20    
  1250.                     50
  1251.                     110
  1252.  
  1253.                     The first entry would deny access to all users with a 
  1254.                     security level of 20.  The second would deny level 50
  1255.                     users, etc.
  1256.        
  1257.       
  1258.       Editing the name trash file
  1259.      -----------------------------
  1260.         Deleting a record : To delete a record, type D from the name editing
  1261.         menu.  This will toggle the delete flag in the record.
  1262.  
  1263.         Adding a record : To add a record, type A from the name editing menu.
  1264.         After entering all the information, the record will be saved to disk.
  1265.  
  1266.         Changing the node affected : To change the node affected, type O 
  1267.         from the name editing menu.  If you select 0 as the node affected, 
  1268.         LoopBack will assume that you would like this record to affect all
  1269.         nodes.
  1270.  
  1271.         Changing the name : To change the name that is being disallowed 
  1272.         access from LoopBack, type N from the name editing menu.  This field
  1273.         is not case sensitive, because after you enter the information, the
  1274.         field is automatically converted to uppercase.
  1275.  
  1276.         NOTE: The text you enter for the name need not be a name at all.. It
  1277.               can be a subset of a name.  The reason for this is that LoopBack
  1278.               tests to see if the text in the name trash file exists within
  1279.               the user's name.  ie.
  1280.                
  1281.               Say you have the following name in the Username trash file:
  1282.  
  1283.                          JONES
  1284.  
  1285.               A person with the name of Frank Jones would be denied access,
  1286.               as well as someone with the name of Allison Jones.
  1287.  
  1288.               
  1289.               But say you have this in the Username trash file:
  1290.  
  1291.                         AL SMITH
  1292.  
  1293.               A person with the the name of Al Smith would be denied access,
  1294.               but someone with the name of Lacy Smith would NOT be denied
  1295.               access.
  1296.  
  1297.  
  1298.       Editing the security trash file
  1299.      ---------------------------------
  1300.         Deleting a record : To delete a record, type D from the editor menu.
  1301.         This will toggle the delete flag in the record.
  1302.  
  1303.         Adding a record : To add a record, type A from the editor menu.  
  1304.         After all the information has been edited, the record will be saved to
  1305.         the file.
  1306.  
  1307.         Changing the node affected : To change the node affected, type O 
  1308.         from the editor menu.  If you select 0 as the node affected, LoopBack 
  1309.         will assume that you would like this record to affect all nodes.
  1310.  
  1311.         Changing the security level : To change the security level that will
  1312.         be disallowed access from LoopBack, type S from the editor menu. 
  1313.  
  1314.       Packing the trash files
  1315.      -------------------------
  1316.         To pack the trash files, you must first select "Security & Name trash
  1317.         files" from the LoopUtil menu.  Then select Pack.  After that, you
  1318.         must select which file you would like to pack.  During the packing 
  1319.         process, LoopUtil will remove any records that have the delete flag
  1320.         set to yes.
  1321.  
  1322. ------------------------------------------------------------------------------
  1323. Allowed Calling #s listing:
  1324. ----------------------------
  1325.  
  1326.         The allowed calling numbers listing is the file where you define    
  1327.         which areacodes/country codes & prefixes/city codes that LoopBack is
  1328.         allowed to callback.
  1329.       
  1330.       Editing the Allowed Calling #s listing:
  1331.      -----------------------------------------
  1332.         
  1333.         (See section on wildcards later in the manual for more information)
  1334.  
  1335.         Wildcard support : LoopUtil boasts the support of wildcards in both 
  1336.         the areacode/country code and prefix/city code fields!  Here is a 
  1337.         brief example of how you would use wildcards in the allowed calling
  1338.         #s file.
  1339.          
  1340.            Say you are in the 812 areacode and the local prefixes in this 
  1341.            areacode are 421, 422, 423, and 464.  You do not want to allow 
  1342.            toll calls.  (Long distance calls to numbers in the same areacode)
  1343.            But you also want LoopBack to callback long distance numbers.  (It 
  1344.            doesn't matter which areacode they are in)
  1345.  
  1346.            You could set your allowed calling #s file up like this:
  1347.             
  1348.                 Record #1:  Areacode = 812   Prefix = 421  International = No
  1349.                             Dialing template = LOCAL
  1350.  
  1351.                 Record #2:  Areacode = 812   Prefix = 422  International = No
  1352.                             Dialing template = LOCAL
  1353.  
  1354.                 Record #3:  Areacode = 812   Prefix = 423  International = No
  1355.                             Dialing template = LOCAL
  1356.  
  1357.                 Record #4:  Areacode = 812   Prefix = 464  International = No
  1358.                             Dialing template = LOCAL
  1359.  
  1360.                 Record #5:  Areacode = XXX   Prefix = XXX  International = No
  1361.                             Dialing template = LONGDIST
  1362.  
  1363.                 Notice record number 5..  It may look strange, but this is 
  1364.                 the way it works.  Say someone types in a number with the 
  1365.                 areacode 812 and prefix 422.  LoopBack will search record 1 
  1366.                 and see there is no match.  It will then search record 2 and 
  1367.                 see that there is a match and it will use the LOCAL dialing
  1368.                 template.  Say someone enter a number with areacode 801 and
  1369.                 prefix 261.  LoopBack will search the first four records and
  1370.                 see that there is not a match.  It will then go on to the 
  1371.                 fifth record and see that the areacode field is a wildcard
  1372.                 field.  So the 801 areacode is ok.  It will then notice that
  1373.                 the prefix field is a wildcard field.  So it has found a 
  1374.                 match and it will be using the LONGDIST dialing template.
  1375.  
  1376.            Here's another situtation..  You are in the 812 areacode and the
  1377.            prefixes 421 and 422 are local.  All other prefixes are toll calls
  1378.            and require the TOLL dialing template.  (Dialing templates will be
  1379.            discussed later in the manual).  You do not want to allow long 
  1380.            distance callbacks..  Just local and toll callbacks.
  1381.  
  1382.            Your allowed #'s calling file might look like this.
  1383.                 
  1384.                 Record #1:  Areacode = 812   Prefix = 421  International = No
  1385.                             Dialing template = LOCAL
  1386.  
  1387.                 Record #2:  Areacode = 812   Prefix = 422  International = No
  1388.                             Dialing template = LOCAL
  1389.  
  1390.                 Record #3:  Areacode = 812   Prefix = XXX  International = No
  1391.                             Dialing template = TOLL
  1392.  
  1393.                 Notice the 3rd record.  You may be thinking, "Well, won't 
  1394.                 LoopBack consider every prefix a toll call since I have the 
  1395.                 wildcard XXX specified in the 3rd record?".   The answer is
  1396.                 no.  If a user enters a number with the areacode 812 and the
  1397.                 prefix 421, then LoopBack will see a match in the first record
  1398.                 and it will look no further.  However, if a user enters a 
  1399.                 number with the areacode 812 and prefix 874, then LoopBack 
  1400.                 will see the wildcard in record 3 and will look no further.
  1401.  
  1402.            NOTE:  If your allowed # calling file contains a LOT of wildcards,
  1403.                   then the searching process may be slow.  If you have a 
  1404.                   wildcard that stands for approximately 50 numbers or more,
  1405.                   go ahead and leave it in there.  If you have a wildcard 
  1406.                   that stands for less than 50 numbers, it would be better to
  1407.                   enter each number individually.  This will help to speed 
  1408.                   up the searches.
  1409.            
  1410.            I realize this may be confusing, so if you are still confused, 
  1411.            please call (609) 587-2672 and leave Bob Watson a private message.
  1412.            I will get back to you with a followup message on the same day.
  1413.  
  1414.  
  1415.         
  1416.         Deleting a record : To delete a record, type D from the editor menu.
  1417.         This will toggle the delete flag.
  1418.  
  1419.         Adding a record : To add a record, type A from the editor menu.  
  1420.         After entering all the information, your record will be saved.
  1421.  
  1422.         International flag : To flag a record as an international record, 
  1423.         type I from the editor menu.  This will tell LoopBack & LoopUtil that  
  1424.         the areacode is really a countrycode and that the prefix is really a
  1425.         city code.
  1426.  
  1427.         Changing the areacode/country code : To change the areacode field, 
  1428.         type C from the editor menu.  
  1429.  
  1430.         Changing the prefix/city code : To change the prefix field, type P
  1431.         from the editor menu.
  1432.  
  1433.         Changing the dialing template : To change the name of the dialing 
  1434.         template to use, type T from the editor menu.  (Dialing templates
  1435.         are discussed later in the manual)
  1436.  
  1437.       Exporting the allowed calling #s file to a text file
  1438.      ------------------------------------------------------
  1439.         LoopUtil will only export NON-INTERNATIONAL numbers.  All international
  1440.         numbers that were not exported will be placed in a report file so that
  1441.         you may enter them manually.
  1442.  
  1443.         To export the allowed calling #s file to a text file, you must first
  1444.         select A from the LoopUtil main menu.  Then you must type X at the next
  1445.         menu.  After that, LoopUtil will ask you for the path & filename of the
  1446.         file to export to.  Then LoopUtil will ask you for the path & filename
  1447.         of the file to use as your report file.  After all this is done, 
  1448.         LoopUtil will begin to export the records.
  1449.  
  1450.  
  1451.       Importing a text file into the allowed calling #s file
  1452.      --------------------------------------------------------
  1453.         If you have a list of areacodes and prefixes in a text file that you
  1454.         would like to import into the allowed calling #s file, then this is
  1455.         the option for you.  NOTE: LoopUTIL WILL ONLY IMPORT NON-INTERNATIONAL
  1456.         NUMBERS!  INTERNATIONAL NUMBERS MUST BE IMPORTED MANUALLY!
  1457.  
  1458.         To import a text file into the allowed calling #s file, you must 
  1459.         first select A from the LoopUtil main menu.  Then you must type I at
  1460.         the next menu.  After that, LoopUtil will ask you for the path and
  1461.         filename of the text file to import.  Then, LoopUtil will ask you for
  1462.         the dialing template that it should use for each record that it 
  1463.         imports into the database.  After all that, LoopBack will begin to 
  1464.         read in your text file and import each line as a seperate record in
  1465.         the allowed calling #s database.  
  1466.         
  1467.         The text file must be formatted in the following way:
  1468.          
  1469.             EACH LINE : XXX-XXX
  1470.             OR        : XXXXXX
  1471.             OR        : (XXX)XXX
  1472.             ETC., ETC.
  1473.  
  1474.             LoopUtil will strip out the following characters: ( ) - ,
  1475.             as well as spaces.
  1476.  
  1477.             The first three characters must be either XXX (Areacode wildcard)
  1478.             or the areacode.  The next three characters must be XXX (Prefix
  1479.             wildcard) or the prefix  
  1480.             
  1481.             Your file may look like this:
  1482.              
  1483.                812-421
  1484.                812-422
  1485.                812-423
  1486.  
  1487.       Indexing the allowed calling #s file
  1488.      --------------------------------------
  1489.         LoopBack supports the ability to search an index file in order to 
  1490.         locate records in the allowed calling #s file.  In order for LoopBack
  1491.         to operate properly, you MUST create an index file.
  1492.  
  1493.         To index the allowed calling #s file, type A at the LoopUtil main menu.
  1494.         Then type N at the next menu.  After you do this, LoopUtil will begin
  1495.         to index each record in the allowed calling #s file.
  1496.  
  1497.  
  1498.       Packing the allowed calling #s file
  1499.      -------------------------------------
  1500.         To pack the allowed calling #s file, type A at the LoopUtil main menu.
  1501.         Then type P at the next menu.  After you do this, LoopUtil will go 
  1502.         through the database and remove any records that have the delete flag
  1503.         set to "Yes".
  1504.  
  1505. ------------------------------------------------------------------------------
  1506. Dialing templates file:
  1507. ------------------------
  1508.  
  1509.         The dialing templates file is used by LoopBack to figure out how it
  1510.         should dial the numbers.  In the allowed calling #s file, you define
  1511.         which dialing template LoopBack should use for each record.
  1512.  
  1513.         Editing the dialing templates file
  1514.        ------------------------------------
  1515.         To enter the dialing templates editor, type A from the LoopUtil main
  1516.         menu.  Then, type D from the next menu.
  1517.  
  1518.         Deleting a record : To delete a record, type D from the editor menu.
  1519.         This will toggle the delete flag.
  1520.  
  1521.         Adding a record : To add a record, type A from the editor menu.  
  1522.         After entering all the information, your record will be saved.
  1523.  
  1524.         Changing the name of the template : To change the name of one of the
  1525.         dialing templates, type N from the editor menu.  Then type the new
  1526.         name of the template.
  1527.  
  1528.         Logoff the user after callback : This toggle will tell LoopBack 
  1529.         whether or not it should log the user off after calling him/her back
  1530.         with that template.  To change the toggle, type L from the editor 
  1531.         menu.
  1532.  
  1533.         Security level to upgrade to : This setting will tell LoopBack what
  1534.         value to put in place of the user's security level when he/she is
  1535.         successfully verified with that template.  To change this setting,
  1536.         type S from the editor menu.  If you set this value equal to 0, 
  1537.         LoopBack will not attempt to upgrade the user's security level.
  1538.  
  1539.         Expired security level to upgrade to : This setting will tell LoopBack
  1540.         what value to put in place of the user's expired security level when
  1541.         he/she is successfully verified with that template.  To change this
  1542.         setting, type E from the editor menu.  If you set this value to 0, 
  1543.         LoopBack will not attempt to upgrade the user's expired security 
  1544.         level.
  1545.  
  1546.         # of days till expiration : This setting will tell LoopBack the number
  1547.         of days to add to the verification date (The date that the user was
  1548.         called back).  The value obtained from the adding of the current date
  1549.         plus this setting will be put in place of the user's expiration date.
  1550.         To change this setting, type # from the editor menu.  If you set this
  1551.         value to 0, LoopBack will not attempt to upgrade the user's expiration
  1552.         date.
  1553.  
  1554.         Template to use when dialing : This setting will tell LoopBack the 
  1555.         way that it is supposed to dial numbers that use this template.  You
  1556.         may either select one of the (R)eady-made templates, or you may 
  1557.         (D)esign your own.  Here is a list of the (R)eady-made templates:
  1558.          
  1559.               (L)ocal     -- Ready-made local dialing template
  1560.          Long (D)istance  -- Ready-made long distance dialing template
  1561.               (T)oll      -- Ready-made toll call dialing template
  1562.  
  1563.               (L)ocal settings : LoopBack will dial a number with the 
  1564.                                  following settings when using a template 
  1565.                                  setup with the (L)ocal ready-made settings:
  1566.  
  1567.               NUMPREFIX + PREFIX/CITYCODE + NUMBER + NUMSUFFIX
  1568.  
  1569.       Long (D)istance settings : LoopBack will dial a number with the 
  1570.                                  following settings when using a template
  1571.                                  setup with the Long (D)istance ready-made
  1572.                                  settings:
  1573.  
  1574.     NUMPREFIX+LDACCESS+COUNTRYCODE/AREACODE+PREFIX/CITYCODE+NUMBER+NUMSUFFIX
  1575.  
  1576.                (T)oll settings : LoopBack will dial a number with the 
  1577.                                  following settings when using a template
  1578.                                  setup with the (T)oll ready-made settings:
  1579.  
  1580.            NUMPREFIX + LDACCESS + PREFIX/CITYCODE + NUMBER + NUMSUFFIX
  1581.      
  1582.         
  1583.         
  1584.         Should you decide to design your own dialing templates because of a
  1585.         different dialing scheme in your area, then you need to read this 
  1586.         section very carefully.
  1587.  
  1588.         There are 6 different fields that LoopBack can use when dialing.  Each
  1589.         field can contain any one of 7 different strings.  The seven strings
  1590.         are as follows:
  1591.          
  1592.              0 = None
  1593.              1 = NUMPREFIX (As setup in config settings)
  1594.              2 = Long distance access code (As setup in config settings)
  1595.              3 = AreaCode/Country Code
  1596.              4 = Prefix/City Code
  1597.              5 = Number
  1598.              6 = NUMSUFFIX (As setup in config settings)
  1599.  
  1600.         LoopBack dial with each field in order.  For example, if you have 
  1601.         the NUMPREFIX set for Field 1, the Prefix/City Code for Field 2, the
  1602.         Number for Field 3, and None for the other 3 fields, LoopBack will 
  1603.         dial like this:
  1604.          
  1605.               NUMPREFIX = 9,   Number user enters = 812-423-3394
  1606.  
  1607.               LoopBack will dial :  NUMPREFIX + PREFIX/CITYCODE + NUMBER
  1608.               or                :          9,4233394
  1609.  
  1610.         If you have any questions on this, please call (609) 587-2672 and
  1611.         leave a private to Bob Watson.  I will get back to you the same day
  1612.         with a followup message.
  1613.  
  1614.         
  1615.         Packing the dialing templates file
  1616.        ------------------------------------
  1617.         To pack the dialing templates file, you must first type A from the
  1618.         LoopUtil main menu.  Then, you must type T from the next menu.  After
  1619.         that, LoopBack will begin to pack the dialing templates file by 
  1620.         removing any record that has the delete flag set to "Yes".
  1621.  
  1622. ------------------------------------------------------------------------------
  1623. Wildcards:
  1624. -----------
  1625.  
  1626.         Wildcards may be used in both the Bad Number file and the Allowed #
  1627.         calling file.  In the Bad number file, you may specify a wildcard in
  1628.         any of the three fields.  (Areacode/CountryCode, Prefix/CityCode, and
  1629.         Number)  If the allowed # calling file, you may specify a wildcard in
  1630.         any of the two fields.  (Areacode/CountryCode, Prefix/CityCode, and
  1631.         Number)
  1632.  
  1633.         NOTE: When using wildcards in the Allowed #s Calling file, please 
  1634.               keep in mind that the more wildcards you have, the slower the
  1635.               searches will be.  So try to have as little as you can.
  1636.         
  1637.  
  1638.         Use of wildcards in Bad Number File
  1639.        -------------------------------------
  1640.         You may use wildcards in the bad number file to specify an
  1641.         areacode/country code, prefix/city code or number as a bad number.
  1642.  
  1643.         For example.  If you wanted to specify all calls to long distance
  1644.         information as a bad number, you would specify the following in the
  1645.         bad number file editor. 
  1646.          
  1647.                    XXX = Areacode/Country Code
  1648.                    555 = Prefix/City Code
  1649.                   1212 = Number
  1650.  
  1651.                   Notice the XXX in the Areacode/Country Code field.  This 
  1652.                   means that if a user enters 801-555-1212 or 212-555-1212 as
  1653.                   a number, LoopBack will see it in the Bad number file and 
  1654.                   act accordingly.
  1655.  
  1656.         But what if we wanted to specify any number with an areacode that 
  1657.         begins with 9 as a bad number.  You would specify the following in
  1658.         the bad number file editor.
  1659.  
  1660.                    9XX = Areacode/Country Code
  1661.                    XXX = Prefix/City Code
  1662.                   XXXX = Number
  1663.  
  1664.                   Notice the 9XX in the Areacode/Country Code field.  This 
  1665.                   means that if a user enters the number 900-867-9888 or
  1666.                   976-887-6764, then LoopBack will recognize it as a bad 
  1667.                   number.  But if the user enters 800-867-9888, then LoopBack
  1668.                   will not recognize it as a bad number.
  1669.  
  1670.         Use of wildcards in the Allowed #s Calling File
  1671.        -------------------------------------------------
  1672.         You may use wildcards in the bad number file to specify an
  1673.         areacode/country code, or prefix/city code or number as a number
  1674.         that LoopBack is allowed to call back.
  1675.  
  1676.         For example.  If you wanted LoopBack to callback the prefixes 421, and
  1677.         422 in the areacode 812 (These are local prefixes using the LOCAL 
  1678.         template), but wanted to specify every other prefix in the areacode
  1679.         812 as a long distance number (Utilizing the LONGDIST template), then
  1680.         you would set it up something like this:
  1681.          
  1682.                 Record #1  
  1683.                   812 = AreaCode/Country Code  
  1684.                   421 = Prefix/City Code
  1685.                 LOCAL = Dialing Template
  1686.  
  1687.                 Record #2
  1688.                   812 = AreaCode/Country Code
  1689.                   422 = Prefix/City Code
  1690.                 LOCAL = Dialing Template
  1691.  
  1692.                 Record #3
  1693.                   812 = AreaCode/Country Code
  1694.                   XXX = Prefix/City COde
  1695.              LONGDIST = Dialing Template
  1696.  
  1697.                 If a user called and entered the number 812-422-8765, then  
  1698.                 LoopBack would find that in record #2 and use the LOCAL 
  1699.                 dialing template.  If, however, a user called and entered the
  1700.                 number 812-682-8475, then LoopBack would not find a match in
  1701.                 either of the first two records, but it would see the wildcard
  1702.                 in the third record.  That would tell LoopBack that it had a
  1703.                 match and it would stop the search and continue along.
  1704.  
  1705. ------------------------------------------------------------------------------
  1706. Call-Back Only Mode:
  1707. ---------------------
  1708.        
  1709.         The only difference between regular call-back mode and call-back 
  1710.         only mode is that when the user is called back he/she does not have
  1711.         to enter verification information, and he/she will not be upgraded
  1712.         upon callback.  Also, the "Logoff user after callback" information
  1713.         in the dialing templates will be disregarded.  After callback, the
  1714.         user will simply be returned to the main board.
  1715.         
  1716.         You can tell LoopBack to execute in call-back ONLY mode with a simple 
  1717.         commandline parameter.  Let's assume the command to execute the
  1718.         LOOPBACK.PPE file is CALLBACK.  To execute LoopBack in call-back only
  1719.         mode, you could type CALLBACK CBONLY at the main menu.  There are 
  1720.         many other ways in which you could do this.  Here are a couple..
  1721.         
  1722.         LoopBack will also keep a log of who was called back in call-back only
  1723.         mode, what time & date they were called back, and what number was 
  1724.         used to call them back.  It keeps all this information in an ASCII
  1725.         text file called LOOPBACK.CAL.  This file can be used to keep track
  1726.         of who used the service and bill them accordingly.
  1727.  
  1728.  
  1729.          Seperate command on the main menu
  1730.         -----------------------------------
  1731.        
  1732.          Run PCBSetup and make the following entries into your 
  1733.          CMD.LST file:
  1734.  
  1735.             Command      Security      PPE/Menu File 
  1736.           --------------------------------------------
  1737.             CALLME         110        C:\PCB\PPE\LOOPBACK\LOOPBACK.PPE CBONLY
  1738.  
  1739.             Note:  You can specify any command, security, or path to the
  1740.                    PPE files. 
  1741.  
  1742.          The command CALLME would initiate LOOPBACK into call-back only mode
  1743.          automatically with only one command from the main menu...
  1744.  
  1745.          
  1746.          Login security file
  1747.         ---------------------
  1748.          
  1749.          Create a file with the name matching the security level that you 
  1750.          want to be called back in call-back only mode automatically upon
  1751.          every logon.  ie., if you wish to have users with a security level
  1752.          of 50 be automatically called back in call-back only mode whenever
  1753.          they logon, create the filename  50.
  1754.  
  1755.          Enter a line in the login security file to execute LoopBack in 
  1756.          call-back only mode.  ie.,
  1757.           
  1758.              !C:\PCB\PPE\LOOPBACK\LOOPBACK CBONLY
  1759.  
  1760. ------------------------------------------------------------------------------
  1761. Caller-ID Detection:
  1762. ---------------------
  1763.  
  1764.          If you have caller-id searching enabled, LoopBack will search the 
  1765.          caller-id string for the user's home phone # and his/her data phone
  1766.          #.  If either of the numbers are found in the caller-id string (As
  1767.          returned by the modem), then LoopBack will simply upgrade them 
  1768.          according to the default settings defined in the Configuration 
  1769.          Settings.  After upgrading them, LoopBack will return to the main
  1770.          board.  If neither of the numbers are found in the caller-id string,
  1771.          LoopBack will proceed as normal. (It will allow the user to initiate
  1772.          a callback.)
  1773.  
  1774.          Please see the Configuration Toggles section of this manual to 
  1775.          figure out how to turn caller-id searching on and off.
  1776.  
  1777.          Also, if you wish to use the extended caller-id search capability,
  1778.          you can create a file called LBKCID.CFG and LoopBack will do a few
  1779.          more things for caller-id searching.  In this file, you can 
  1780.          configure a filename that contains caller-id information (if your
  1781.          modem does not return the caller-id information and you have some
  1782.          sort of peripheral hooked up direct to your phone lines), etc.  You
  1783.          can edit this file with your favorite text editor.
  1784.  
  1785.          NOTE:  You do not have to use this file!  If you want to use all the
  1786.                 default settings, and read caller-id info from the modem, you
  1787.                 don't need this file.  However, if you want a more flexible
  1788.                 setup, simply create this file with the following format:
  1789.  
  1790.  
  1791.                      Line #1: Path & name of file that contains caller-id 
  1792.                               info.  (If using caller-id info provided by 
  1793.                               modem, simply leave this field blank)
  1794.  
  1795.                      Line #2: Security level to place user at if either of 
  1796.                               his/her phone numbers are found in the caller 
  1797.                               ID string. (A setting of 0 will disable this 
  1798.                               option.)
  1799.  
  1800.                      Line #3: # of days to add to date of verification to 
  1801.                               place as user's expiration date if his/her 
  1802.                               phone numbers are found in the caller-id string.
  1803.                               (A setting of 0 will disable this option)
  1804.  
  1805.                      Line #4: Value to put in place of user's expiration sec.
  1806.                               level if either of his/her phone numbers are
  1807.                               found in the caller-id string.
  1808.  
  1809.          
  1810.          Your file might look like this:
  1811.  
  1812.            (BLANK)
  1813.            80
  1814.            365
  1815.            20
  1816.  
  1817.          This would search for caller-id information from the modem, and if
  1818.          either of the user's phone numbers were found in the caller-id 
  1819.          string, it would give the user a security level of 80, an expiration
  1820.          date 365 days from the verification date, and an expired security
  1821.          level of 20.
  1822.  
  1823.          NOTE:  
  1824.  
  1825.  
  1826.          Here is a step-by-step list of procedures that LoopBack will do if  
  1827.          either of the user's telephone numbers are found in the caller-id
  1828.          string.
  1829.            
  1830.                1) Notify the user that his/her number was found in the
  1831.                   Caller-ID string.
  1832.  
  1833.                2) Upgrade the user's security level to the value in
  1834.                   the "Default Security level if no callback" in 
  1835.                   config settings. (LBKCID.CFG file can be used to specify
  1836.                   a value other than the Default security level)
  1837.  
  1838.                3) Upgrade the user's expired security level to the 
  1839.                   value in the "Default Expired Security level if no
  1840.                   callback" in config settings.  (LBKCID.CFG file can
  1841.                   be used to specify a value other than the default
  1842.                   expired security level.)
  1843.  
  1844.                4) Upgrade the user's expiration date to the value in
  1845.                   the "Default # days to add to verification date if
  1846.                   no callback" in config settings plus the date in 
  1847.                   which the user entered LoopBack.  (LBKCID.CFG file can
  1848.                   be used to specify an expiration date other than that
  1849.                   configured as the default.)
  1850.  
  1851.                5) Upgrade the user's time, bytes, and files according
  1852.                   to their respective settings.
  1853.  
  1854.                6) Flag a file for download (if so configured) and 
  1855.                   start the download process (if so configured).
  1856.  
  1857.                7) Exit back to PCBoard.
  1858.            
  1859.  
  1860. ------------------------------------------------------------------------------
  1861. Configuring a file to execute before upgrading the user:
  1862. ---------------------------------------------------------
  1863.  
  1864.         If you have a questionnaire of some sort that you would like to 
  1865.         execute prior to upgrading the user, you can do this with LoopBack.
  1866.         See Configuration Toggles and Configuration Settings section in this
  1867.         manual for info on the filename and filetype to execute.
  1868.  
  1869.         A good example of something you could use this for would be to 
  1870.         execute a PPE file or batch file to generate a postcard for printout.
  1871.         All you need to do is specify the filename to execute (via 
  1872.         Configuration Paths) and the filetype to execute (via Configuration
  1873.         Toggles).  
  1874.  
  1875.         Prior to executing any file, LoopBack will save the screen contents.
  1876.         After returning from the external PPE or program, LoopBack will 
  1877.         restore the previously saved screen contents.  If you have a batch
  1878.         file setup to execute, then LoopBack will write an up-to-date USERS.SYS
  1879.         file and PCBOARD.SYS file prior to shelling out to the external 
  1880.         batch file.
  1881.  
  1882.  
  1883. ------------------------------------------------------------------------------
  1884. (L)oopInfo Selection From LoopBack Main Menu:
  1885. --------------------------------------------
  1886.  
  1887.         The (L)oopInfo command from the LoopBack main menu provides the SysOp
  1888.         and/or user with a wealth of information.  It will display the 
  1889.         Executable status. (Date, time, size, and name of the PPE file)  It
  1890.         will display the status of certain LoopBack data files. (name of file,
  1891.         # of records, file size, etc.)  It will display the registration 
  1892.         status. (SysOp's name, registration code, etc.)  It will also display
  1893.         a graph of the total # of users on the system that have been verified.
  1894.         When you build your Already Used # database or when you pack your 
  1895.         users file, this graph will become inaccurate.  When you build your
  1896.         Already Used # database or when you pack your users file, update the
  1897.         Total Number of Callbacks setting in the Statistics file maintenance.
  1898.  
  1899.         For example, if you have 500 users (300 Total Callbacks) and you 
  1900.         pack your USERS file (from PCBoard) which packs it down to 475 users,
  1901.         then you must adjust your Total Callbacks setting accordingly.  So if
  1902.         25 users were deleted from the users file, and say 15 of them were 
  1903.         verified users, then you must subtract 15 from your Total Callbacks 
  1904.         setting.  (Thus leaving it at 285 Total Callbacks)
  1905.  
  1906.         If you wish, the (L)oopInfo screen can be disabled via an environment
  1907.         switch.  (Please read the section on "Environment Switches", explained
  1908.         earlier in the manual.
  1909.  
  1910. ------------------------------------------------------------------------------
  1911. Display Files:
  1912. ---------------
  1913.  
  1914.         LoopBack Main Menu
  1915.        -------------------
  1916.         You may wish to customize the LoopBack main menu file.  The filename
  1917.         is LoopWC.  It can be graphics, security, and/or language specific. 
  1918.         (See your PCBoard manual for more information on graphics, language,
  1919.         and security specific files.)
  1920.  
  1921.         LoopBack Number Menu
  1922.        ---------------------
  1923.         The number menu file is the menu that is displayed when the user is
  1924.         selecting the number that is to be called back.  The filename is 
  1925.         defined in the configuration paths.  (Default filename is LoopNMNU)
  1926.         It can be graphics and/or language specific.
  1927.     
  1928.         LoopBack Searching Display
  1929.        ---------------------------
  1930.         The searching display file is the file that is displayed prior to 
  1931.         searching all the database files.  The filename is SCDISP.  This 
  1932.         file can be graphics and/or language specific.  
  1933.          
  1934.         LoopBack CallBack Display
  1935.        --------------------------
  1936.         The callback display is the file that is displayed prior to hanging
  1937.         up on the user and calling him/her back.  This screen will remain on
  1938.         the caller's screen until he/she is called back.  The filename is
  1939.         LoopCAL.  This file can be graphics and/or language specific.
  1940.  
  1941. ------------------------------------------------------------------------------
  1942. Executing the LOOPBACK.PPE file:
  1943. --------------------------------
  1944.  
  1945.         There are many ways to execute the LoopBack [PPE] file.  Here are a
  1946.         few examples:
  1947.  
  1948.         Login Security File
  1949.        ---------------------
  1950.         Step #1 : Go to your login security files directory (Configured in
  1951.                   PCBSetup)
  1952.  
  1953.         Step #2 : Create a file with the filename matching the security level
  1954.                   of the users that you want to be automatically sent to 
  1955.                   LOOPBACK.PPE upon login (Your NEWUSER security level is 
  1956.                   usually 10)
  1957.  
  1958.                   Example.  If your NEWUSER security level (user that you 
  1959.                             want to enter LoopBack) is level 10, then your 
  1960.                             filename would be: 10
  1961.  
  1962.                             To create this with the DOS editor, type:
  1963.  
  1964.                                        EDIT 10.
  1965.  
  1966.                             at the command line.
  1967.  
  1968.         Step #3 : This is just a display file so you can add some text to 
  1969.                   tell the caller that he/she is about to enter the LoopBack
  1970.                   Call-Back verifier.
  1971.  
  1972.         Step #4 : Put an exclamation mark followed by the path & filename of
  1973.                   the LoopBack PPE file flush against the left column of the
  1974.                   file after your display text.
  1975.  
  1976.                   Example.  If LOOPBACK.PPE resides in the directory
  1977.                             C:\PCB\PPE\LOOPBACK  then this may be what your 
  1978.                             login security file (10.) would look like.
  1979.  
  1980.                             Stuff to display to next caller.....
  1981.                             blah blah blah
  1982.  
  1983.                             !C:\PCB\PPE\LOOPBACK\LOOPBACK.PPE
  1984.  
  1985.  
  1986.         Step #5 : When all else fails, consult your PCBoard manual and/or
  1987.                   call our support BBS at (609) 587-2672 for support.
  1988.  
  1989.  
  1990.         Command From the Main Menu
  1991.        ---------------------------
  1992.  
  1993.         Step #1 : Run PCBSETUP and edit your CMD.LST file to have the 
  1994.                   following information.
  1995.  
  1996.                    Command      Security      PPE/Menu File 
  1997.                  --------------------------------------------
  1998.                    CALLBACK         0        C:\PCB\PPE\LOOPBACK\LOOPBACK.PPE
  1999.                    ^^^^^^^^         ^        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  2000.                       |             |         This is the path & filename of
  2001.                       |             |         the LoopBack PPE file.
  2002.                       |             |
  2003.                       |        Set this to your NEWUSER security level or the
  2004.                       |        security level you want entering LOOPBACK
  2005.                       /
  2006.              This can be any command you like. (This is the command from the
  2007.              main menu that executes LOOPBACK
  2008.  
  2009.         Step #2 : Save your CMD.LST file and that's it.
  2010.  
  2011. ------------------------------------------------------------------------------
  2012. Explanation of terms:
  2013. ----------------------
  2014.      
  2015.      Archive - A file (usually a ZIP file) that contains other files and/or
  2016.                other paths within it.  Archives are used by bulletin boards
  2017.                to compress data and make file transfers faster.  You will 
  2018.                need a program, such as PKZip to compress and decompress 
  2019.                archives.
  2020.  
  2021.  BOYER-MOORE - The BOYER-MOORE searching algorithm that LoopBack supports is
  2022.                very powerful.  You can use the & (LOGICAL AND), | (LOGICAL OR)
  2023.                etc. to search for a specific criteria.
  2024.  
  2025. Leading zero - A leading zero is a zero in front of a number.  An example of
  2026.                leading zeros in phone numbers:
  2027.                 
  2028.                    812-423-0043
  2029.                            ^^
  2030.                            These two zeros are leading zeros.
  2031.  
  2032.          PPE - PCBoard Programming Language Executable
  2033.  
  2034.          PPL - PCBoard Programming Language
  2035.  
  2036.      Setting - See Variable
  2037.       
  2038.         Tick - A tick is merely a fraction of a second.  18.2 ticks equals 
  2039.                one second.  182 ticks equals 10 seconds.  1080 ticks equals
  2040.                60 seconds, etc.
  2041.  
  2042.       Toggle - A toggle is a switch, or something you can turn on or off.  
  2043.                For example, "Logoff user after verification" is a toggle 
  2044.                because you do not give it a value, you just turn it on or 
  2045.                off.
  2046.  
  2047.    Toll Call - A toll call is a call to a phone number that has a local area
  2048.                code, but a long distance prefix.  Some larger cities require
  2049.                that you dial the areacode along with the number, while other
  2050.                cities do not require this.
  2051.  
  2052.     Variable - A setting which variates or can be changed.  For example, the
  2053.                expired security level is a variable because you can change it
  2054.                to different values.
  2055.  
  2056.  
  2057. ------------------------------------------------------------------------------
  2058. Manual updates:
  2059. ----------------
  2060.  
  2061.         If you see something missing in this manual that you would like 
  2062.         included, or if there is something you are confused about, then 
  2063.         contact PCS (Ways to contact are listed in the Registration
  2064.         section of this manual) and state the changes that you would like
  2065.         to see in the next revision.
  2066.  
  2067. ------------------------------------------------------------------------------
  2068.